home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / bbs / iserv250.zip / ISERVER.DOC < prev    next >
Text File  |  1995-12-15  |  13KB  |  333 lines
  1.  
  2.    ▀  █▀▀ █▀▀ █▀█ █ █ █▀▀ █▀█
  3.    █  ▀▀█ █▀  █▀▄ █ █ █▀  █▀▄  I n t e r n e t   S e r v e r   R e l a y
  4.    ▀  ▀▀▀ ▀▀▀ ▀ ▀  ▀  ▀▀▀ ▀ ▀
  5.  
  6.    Copyright Mulitboard Communications Centre, 1995
  7.    All rights reserved.
  8.  
  9.  
  10.  What does this program do?
  11.  ══════════════════════════════════════════════════════════════════════─────
  12.  
  13.    iServer will import email from a fidonet netmail format directly into
  14.    your RemoteAccess system as internet email.  No longer will your users
  15.    have to know anything about addressing to "UUCP" at some obscure netmail
  16.    address.  Of course, it will also export outbound mail from your BBS and
  17.    prepare them in a netmail fashion, ready to be gated out.
  18.  
  19.  
  20.  A complete solution!
  21.  ══════════════════════════════════════════════════════════════════════─────
  22.  
  23.    iServer is not only a tosser for your mail, but a powerful server engine
  24.    as well.  iServer can automatically bounce mail addressed to unknown
  25.    users on your system, or repond to inbound messages automatically.  With
  26.    iServer and its request/respond system, you can build powerful applica-
  27.    tions to interface with your basic email system, such as info-bots,
  28.    listserv and ftpmail.  Outbound messages can be restricted on site, user
  29.    security settings and the number of messages posted per user.  You also
  30.    have the option to restrict file transfers via email, such as UUENCODED,
  31.    BASE64 or MIME formatted messages.
  32.  
  33.    iServer integrates completely and seemlessly with your RemoteAccess
  34.    system, using it's data files for user verification, as well as obtaining
  35.    user security information for its message restricting features.
  36.  
  37.      ■ Seamless integration with RemoteAccess 2.x
  38.      ■ Direct import/export of email
  39.      ■ Powerful server response engine
  40.      ■ Bounce messages to unknown users
  41.      ■ Merge mailing lists as usegroups
  42.      ■ Restrict certain sites, functions or encoded files
  43.      ■ Custom templates for bounce messages
  44.      ■ Dumb address checking
  45.      ■ Disclaimer message support
  46.      ■ Excellent author support
  47.  
  48.  
  49.  What do I need to set this program up?
  50.  ══════════════════════════════════════════════════════════════════════─────
  51.  
  52.   In order to use this program you will need:
  53.  
  54.     1) Your system to use a fidonet style frontend mailer that *.MSG files
  55.        in it's inbound/outbound netmail directory.  (for example: FrontDoor,
  56.        Intermail and a number of others)
  57.  
  58.     2) RemoteAccess 2.x or another BBS software package that can use the
  59.        JAM message base format.
  60.  
  61.   Basic setup method:
  62.  
  63.     1) Create a message base on your BBS.  For RemoteAccess, it should
  64.        be an "Internet" or "Echomail" style area, "JAM" type with the
  65.        "Private" mail only setting.  This is not the same as your
  66.        regular netmail area.
  67.  
  68.     2) Run ISERVCFG.EXE to setup iServer.  (there is lots and lots of
  69.        online help, just press F1)
  70.  
  71.     3) Put ISERVER.EXE in your RUNBBS.BAT file, after receiving netmail
  72.        and after the user logs off (or optionally during an event)
  73.  
  74.     4) You're done!
  75.  
  76.  
  77.   Advanced setup method:
  78.  
  79.     This method, albeit a little more involved, will provide you with
  80.     the best setup, since it keeps your netmail and internet email
  81.     completely seperate from each other.
  82.  
  83.     Lets assume for this example that your standard fidonet address
  84.     is 7:8/9, you would:
  85.  
  86.     1) Complete steps 1 & 2 from the basic setup
  87.  
  88.     2) Create an aka in your mailer of 7:8/9.999
  89.  
  90.     3) Setup your site address in ISERVCFG as the above
  91.  
  92.        (* THIS IS THE BIG PART *)
  93.  
  94.     4) Setup your netmail tosser to ignore mail to 7:8/9.999.
  95.        (not import it into the netmail area in your BBS, since iServer
  96.        is the one that should be doing the importing for this mail)
  97.        Doing this means that your netmail/echomail tosser will never
  98.        accidentally grab the inbound mail that is meant for iServer.
  99.        If you do not use this advanced method, it means you must
  100.        *always* run iServer before your tosser imports netmail.
  101.  
  102.     5) You're done!  It really isn't much more difficult, but with
  103.        this method you can be sure that you will never have your
  104.        email and netmail crossed anywhere.
  105.  
  106.  
  107.  What can't I do until I register?
  108.  ══════════════════════════════════════════════════════════════════════─────
  109.  
  110.    Nothing.  The only limits that are imposed, are that you can only
  111.    have a maxium of 3 RESPOND entries, and 3 RESTRICTS until registered.
  112.    You also cannot use any TABLE entries until you have registered.
  113.    It will also remove the unregistered notice, and the 2 second delay.
  114.    Please register, a lot of effort went into developing the program,
  115.    and the price is quite reasonable.
  116.  
  117.    Please note that registration keys are built on your site address
  118.    and site name, so make sure that they are correct.
  119.  
  120.  
  121.  Special files
  122.  ══════════════════════════════════════════════════════════════════════─────
  123.  
  124.    ADDRESS.BAD    - Custom message to send when the user has addressed
  125.                     a message to what appears to be an invalid account.
  126.  
  127.    LIMIT.BAD      - Custom message to send when a user does not have
  128.                     sufficient credit to post a message.
  129.  
  130.    SITE.BAD       - Custom message to send when a user posts to a site
  131.                     that you have marked as restricted.
  132.  
  133.    SUBJECT.BAD    - Custom message to send when a user attempts to post
  134.                     to a function that you have restricted.
  135.  
  136.    USER.BAD       - Custom message to send to the originator of a message
  137.                     when an inbound message is not addressed to anyone
  138.                     valid on your system.
  139.  
  140.    UUENCODE.BAD   - Custom message to send when a user attempts to pass
  141.                     a encoded file through your gateway.
  142.  
  143.    DISCLAIM.MSG   - A custom disclaimer to add to the bottom of your
  144.                     outgoing messages.  Delete this file if you do not
  145.                     want one.
  146.  
  147.    RESPOND.MSG    - A custom template for creating request/respond
  148.                     files during a 'RESPOND' command.  If you wish to
  149.                     use the standard one (compatible with version 1.x)
  150.                     simply delete this file.
  151.  
  152.    METALIST.TXT   - A listing of all the possible metastrings you can
  153.                     use in your custom templated messages.
  154.  
  155.  
  156.  
  157.  Command line parameters
  158.  ══════════════════════════════════════════════════════════════════════─────
  159.  
  160.    Typing ISERVER /? will bring up a list of command line options.
  161.    Normally, just running ISERVER.EXE is sufficient, but there are
  162.    other options available.
  163.  
  164.    Import/export mail parameters
  165.  
  166.       /PROCESS                     Standard behaviour (default)
  167.       /FORCE                       Ignore last scanning markers
  168.       /NOMARK                      Do not update high scan marks
  169.       /NOSCAN                      Do not scan for outgoing mail
  170.       /NOTOSS                      Do not toss incoming mail
  171.       /NOMGR                       Do not process requests/bounce unknown
  172.  
  173.    Online programs and parameters
  174.  
  175.       /USERID droppath             Userid creation (if flag not toggled)
  176.       /USERID droppath /FORCE      Userid creation (always)
  177.  
  178.    Utilities
  179.  
  180.       /TABLE tablename [+|-]user   Add/remove user from a table
  181.  
  182.  
  183.  
  184.    What is /USERID?
  185.  
  186.    This program simply gives the user an interface to change their
  187.    user alias to something that looks more professional on the internet
  188.    if they wish.  You can setup restrictions for this alias in the
  189.    ISERVCFG program.
  190.  
  191.    To implement this, you would change the message area on the BBS to
  192.    "Use Handles Only" which would then post the message from their
  193.    alias.  This way, they can have a name like "roccap@yoursite.com"
  194.    if they choose.
  195.  
  196.    The online program options are to run the userid (handle creation)
  197.    part of the program.  The /FORCE overrides if the user has already
  198.    set the user flag as defined in ISERVCFG.
  199.  
  200.    Examples:  ISERVER.EXE /USERID c:\ra\node1 /FORCE
  201.               ISERVER.EXE /USERID c:\ra
  202.               ISERVER.EXE /USERID c:\ra\node2
  203.  
  204.    Please note that this utility is completely optional and not required
  205.    for the operation of iServer.
  206.  
  207.  
  208.    What is /TABLE?
  209.  
  210.    Tables are simular to "Responds", except you can put a class of
  211.    user names into a table rather than having a seperate trigger
  212.    for each user.
  213.  
  214.    For example, you could have a table of users that were on
  215.    vacation, and if someone posted a message to a user that was in
  216.    the vacation table, it could send them back a message saying
  217.    that they would be delayed in responding.  You could also have
  218.    a table of bad users, and have their inbound mail deleted.
  219.  
  220.    To insert a user into a table, use the following command:
  221.  
  222.    ISERVER /TABLE tablename +User Name
  223.  
  224.    To remove a user from a table, replace the plus sign (+) with a minus
  225.    sign (-).  In the vacation table example, you could allow an option
  226.    from your BBS that allowed them to toggle their own status.
  227.  
  228.    For example:
  229.  
  230.      Vacation
  231.  
  232.        (Y)es    ..  would run ISERVER /TABLE VACATION +*F *L
  233.        (N)o     ..  would run ISERVER /TABLE VACATION -*F *L
  234.  
  235.    Where your BBS would replace *F *L with the user name.
  236.  
  237.    Please note that this utility is completely optional and not required
  238.    for the operation of iServer.
  239.  
  240.  
  241.  Online help
  242.  ══════════════════════════════════════════════════════════════════════─────
  243.  
  244.    The ISERVCFG.EXE program has complete context-sensitive help online
  245.    to provide the easiest method of setting up.  Simply press F1 from
  246.    almost anywhere in the program for help about the menu you are in.
  247.  
  248.  
  249.  Function logging legend
  250.  ══════════════════════════════════════════════════════════════════════─────
  251.  
  252.     ■ - Program startup
  253.     I - Import message
  254.     E - Export message
  255.     B - Bounce message (Unknown user on this system)
  256.     T - Infobot trigger response
  257.     M - Merge mailing list
  258.     X - Table trigger response
  259.     R - Restricted
  260.     C - Consume message (Circular route detection)
  261.     U - Userid selected
  262.  
  263.  
  264.  License and disclaimer
  265.  ══════════════════════════════════════════════════════════════════════─────
  266.  
  267.    "iServer" (also known as "ISR") is NOT free.
  268.  
  269.    It is being marketed under the "try before you buy" or shareware
  270.    concept.  You are entitled to use ISR for a period up to forty-five
  271.    (45) days, after which you MUST register or stop using the program.
  272.  
  273.    Registration entitles you to  use ISR as  well as any future versions
  274.    of this program that may or may not be released, subject to any
  275.    additional licensing conditions which may be attached.
  276.  
  277.    Registration  will also allow you to you the full ability of iServer
  278.    as well as remove the unregistered notice. It will also help to
  279.    continue to develop this program. (not to mention maintain the
  280.    legality of this agreement)
  281.  
  282.    By running any of the executable programs included, you agree that
  283.    Pete Rocca,  Multiboard Communications Centre nor any affiliates of
  284.    the above mentioned are responsible for any damage ever experienced,
  285.    however so created. If you cannot agree to this, then your privilege
  286.    to use any of these programs is revoked and it becomes illegal for
  287.    you to execute any programs included with this documentation.
  288.  
  289.    You may freely copy and distribute the shareware version of ISR as
  290.    long as its original archived contents are not modified in any way.
  291.    You may NOT distribute any registration keys without the express
  292.    written consent of Pete Rocca of Multiboard Communications Centre.
  293.  
  294.    You may not use a registration number that is not licensed from
  295.    Multiboard Communications Centre directly to you.
  296.  
  297.    It is illegal to edit, alter, hack, reverse engineer and / or modify
  298.    any components of the ISR archive in any manner.
  299.  
  300.    If dispute of any issues on legal grounds said above, then governing
  301.    law of Ontario, Canada will rule.
  302.  
  303.  
  304.  Support
  305.  ══════════════════════════════════════════════════════════════════════─────
  306.  
  307.    If you have any questions or comments, you  can netmail me at FidoNet
  308.    address 1:2401/305 (CM,V34,VFC) - please poll back 24 to 48 hours later
  309.    to get your response.
  310.  
  311.    You can also send your mail via internet email to "support@mbcc.com"
  312.    In addition, the following locations have our products available or
  313.    are support channels.
  314.  
  315.    www: www.uti.com/mcc
  316.    ftp: ra.uti.com/sys/bbs/bbs/mcc
  317.    bbs: 519-660-8981
  318.    frq: 1:2401/305
  319.  
  320.  
  321.  Acknowledgments
  322.  ══════════════════════════════════════════════════════════════════════─────
  323.  
  324.    Requires at least DOS 3.3 and SHARE.EXE loaded for the JAM routines.
  325.    Thanks to the public domain swapping utils that required very little
  326.    in the way of tweaking, by Thomas Wagner. iServer/ISR are copyrighted
  327.    products by Multiboard Communications Centre and Pete Rocca.
  328.  
  329.    Remember, please register, it's cheap!
  330.  
  331.    Pete Rocca
  332.    Multiboard Communications Centre
  333.